package com.ruoyi.chat.service;

import com.ruoyi.chat.domain.Dataset;

import java.util.List;

/**
 * 知识库信息Service接口
 * 
 * @author ruoyi
 * @date 2025-03-24
 */
public interface IDatasetService 
{
    /**
     * 查询知识库信息
     * 
     * @param id 知识库信息主键
     * @return 知识库信息
     */
    public Dataset selectDatasetById(Long id);

    /**
     * 查询知识库信息 - 鉴权专用
     *
     * @param ids 知识库信息主键
     * @param userId 当前用户id
     * @param roleIds 当前用户角色id
     * @return 结果条数
     */
    public List<Dataset> selectDatasetByIds(Long[] ids, Long userId, List<Long> roleIds);

    /**
     * 根据名称查询知识库信息
     *
     * @param name 知识库名称
     * @return 知识库信息
     */
    public Dataset selectDatasetByName(String name);

    /**
     * 查询知识库信息列表
     * 
     * @param dataset 知识库信息
     * @return 知识库信息集合
     */
    public List<Dataset> selectDatasetList(Dataset dataset);

    /**
     * 新增知识库信息
     * 
     * @param dataset 知识库信息
     * @return 结果
     */
    public int insertDataset(Dataset dataset);

    /**
     * 新增知识库 - 并调用ragFlow
     *
     * @param dataset 知识库信息
     * @param url ragFlow的地址
     * @return 结果
     */
    public int add(Dataset dataset, String url);

    /**
     * 修改知识库信息
     * 
     * @param dataset 知识库信息
     * @return 结果
     */
    public int updateDataset(Dataset dataset);

    /**
     * 修改知识库信息 - 并调用ragFlow
     *
     * @param dataset 知识库信息
     * @param url ragFlow的地址
     * @return 结果
     */
    public int update(Dataset dataset, String url);

    /**
     * 删除知识库 - 并调用ragFlow
     *
     * @param ids 知识库ids
     * @param url ragFlow的地址
     * @return 结果
     */
    public int delete(Long[] ids, String url);

    /**
     * 知识库通过ids鉴权
     *
     * @param ids 知识库id集合
     * @return 查询到的有权限的知识库id
     */
    public List<Dataset> checkAuth(Long[] ids);

    /**
     * 批量删除知识库信息
     * 
     * @param ids 需要删除的知识库信息主键集合
     * @return 结果
     */
    public int deleteDatasetByIds(Long[] ids);

    /**
     * 删除知识库信息信息
     * 
     * @param id 知识库信息主键
     * @return 结果
     */
    public int deleteDatasetById(Long id);

    /**
     * 知识库入参校验方法
     *
     * @param dataset 知识库
     */
    public void checkParam(Dataset dataset);
}
